Markdown 首要理念与核心架构原则

OpenClaw 基础

1. Markdown 首要理念

OpenClaw 将可读的文档视为绝对真理来源。与将逻辑深埋于数据库中的系统不同，代理的“灵魂”由文本文件定义，确保了透明性以及便捷的版本控制。

SOUL.md： 定义角色与伦理边界。
AGENTS.md： 概述工程工作流程。
MEMORY.md： 存储长期事实与偏好。

2. 模型无关且自主

集中式代理运行时允许在不重写逻辑的前提下切换大语言模型（Claude、GPT、本地）。自主代理通过 HEARTBEAT.md 调度器实现 24/7 运行。

3. 可靠性与数据完整性

为防止高并发环境下的状态损坏，OpenClaw 采用 会话隔离 通过车道队列实现。数据检索由 本地优先 RAG 架构通过语义快照处理。

配置：openclaw.json

{ "global": { "port": 18789, "identity": "./config/SOUL.md", "env_injection": true }, "security": { "firewall": "strict", "rce_protection": true } }

Type a command...

Question 1

Why does OpenClaw prioritize a "Markdown-First" approach?

To increase the execution speed of the LLM.

To ensure transparency and human-readability.

To replace the need for JSON files entirely.

Question 2

What prevents "State Corruption" during simultaneous user interactions?

Local-First RAG

Semantic Snapshots

Session Isolation via Lane Queues

Challenge: The Debugger

Diagnose the missing agent behavior.

Problem: An agent has been deployed, but it is responding with a generic personality instead of its assigned role, and it cannot recall data from yesterday's session.

Analysis

Which files or components are likely misconfigured?

Diagnosis:
1. Persona Issue: Check SOUL.md and ensure it is correctly referenced in openclaw.json.
2. Memory Issue: Ensure MEMORY.md is writable and the Local-First RAG system is successfully creating Semantic Snapshots.